home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / mknod.man < prev    next >
Encoding:
Text File  |  1989-01-12  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MKNOD                 C Library Procedures                  MKNOD
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      mknod - make a special file
  10.  
  11. SSYYNNOOPPSSIISS
  12.      mmkknnoodd((ppaatthh,, mmooddee,, ddeevv))
  13.      cchhaarr **ppaatthh;;
  14.      iinntt mmooddee,, ddeevv;;
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      _M_k_n_o_d creates a new file whose name is _p_a_t_h. The mode of the
  18.      new file (including special file bits) is initialized from
  19.      _m_o_d_e.  (The protection part of the mode is modified by the
  20.      process's mode mask (see _u_m_a_s_k(2))).  The first block
  21.      pointer of the i-node is initialized from _d_e_v and is used to
  22.      specify which device the special file refers to.
  23.  
  24.      If mode indicates a block or character special file, _d_e_v is
  25.      a configuration dependent specification of a character or
  26.      block I/O device.  If _m_o_d_e does not indicate a block special
  27.      or character special device, _d_e_v is ignored.
  28.  
  29.      _M_k_n_o_d may be invoked only by the super-user.
  30.  
  31. RREETTUURRNN VVAALLUUEE
  32.      Upon successful completion a value of 0 is returned.  Other-
  33.      wise, a value of -1 is returned and _e_r_r_n_o is set to indicate
  34.      the error.
  35.  
  36. EERRRROORRSS
  37.      _M_k_n_o_d will fail and the file mode will be unchanged if:
  38.  
  39.      [ENOTDIR]      A component of the path prefix is not a
  40.                     directory.
  41.  
  42.      [EINVAL]       The pathname contains a character with the
  43.                     high-order bit set.
  44.  
  45.      [ENAMETOOLONG] A component of a pathname exceeded 255 char-
  46.                     acters, or an entire path name exceeded 1023
  47.                     characters.
  48.  
  49.      [ENOENT]       A component of the path prefix does not
  50.                     exist.
  51.  
  52.      [EACCES]       Search permission is denied for a component
  53.                     of the path prefix.
  54.  
  55.      [ELOOP]        Too many symbolic links were encountered in
  56.                     translating the pathname.
  57.  
  58.      [EPERM]        The process's effective user ID is not
  59.                     super-user.
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 23, 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MKNOD                 C Library Procedures                  MKNOD
  71.  
  72.  
  73.  
  74.      [EPERM]        The pathname contains a character with the
  75.                     high-order bit set.
  76.  
  77.      [EIO]          An I/O error occurred while making the direc-
  78.                     tory entry or allocating the inode.
  79.  
  80.      [ENOSPC]       The directory in which the entry for the new
  81.                     node is being placed cannot be extended
  82.                     because there is no space left on the file
  83.                     system containing the directory.
  84.  
  85.      [ENOSPC]       There are no free inodes on the file system
  86.                     on which the node is being created.
  87.  
  88.      [EDQUOT]       The directory in which the entry for the new
  89.                     node is being placed cannot be extended
  90.                     because the user's quota of disk blocks on
  91.                     the file system containing the directory has
  92.                     been exhausted.
  93.  
  94.      [EDQUOT]       The user's quota of inodes on the file system
  95.                     on which the node is being created has been
  96.                     exhausted.
  97.  
  98.      [EROFS]        The named file resides on a read-only file
  99.                     system.
  100.  
  101.      [EEXIST]       The named file exists.
  102.  
  103.      [EFAULT]       _P_a_t_h points outside the process's allocated
  104.                     address space.
  105.  
  106. SSEEEE AALLSSOO
  107.      chmod(2), stat(2), umask(2)
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0               May 23, 1986                          2
  130.  
  131.  
  132.  
  133.